home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / fnorddel / fn132man.zoo / intro < prev    next >
Text File  |  1991-09-02  |  9KB  |  307 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18. Fnordadel Reference Manual
  19. ----------------------------------------------------------------------------
  20.                                                                  2nd Edition
  21.                                                          Revised August 1991
  22.                                                   for Fnordadel version 1.32
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Adrian Ashley
  62. Royce Howland
  63. ----------------------------------------------------------------------------
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117. This manual is copyright (C) 1990, 1991 by Adrian Ashley and Royce Howland.
  118.  
  119. Permission  is granted  to  distribute  unmodified copies  of  this  manual,
  120. provided that  no more than  a reasonable handling  and/or materials fee  is
  121. charged for it.
  122.  
  123. Permission is granted to modify this manual and  to distribute such modified
  124. copies, provided  that no more than  a reasonable handling and/or  materials
  125. fee  is charged  for it;  and provided  that  such modified  copies are  not
  126. represented as being  the original Fnordadel Reference Manual;  and provided
  127. that credit is given to the original authors.
  128.  
  129.  
  130.  
  131. Copying Conditions and Credits                                             1
  132.  
  133.  
  134.  
  135.  
  136. Copying Conditions and Credits
  137.  
  138.  
  139.  
  140.  
  141. Copying Conditions
  142.  
  143.    The Fnordadel sources  and binaries are in the  public domain.  They  may
  144. be freely distributed, modified or whatever you like.   If you do distribute
  145. or modify Fnordadel, please adhere to the following conditions:
  146.  
  147.  1. You may not charge more than a reasonable  handling or materials fee for
  148.     Fnordadel sources or binaries.
  149.  
  150.  2. Redistributions of Fnordadel must be complete,  containing all programs,
  151.     documentation and other files present in the original distributions.
  152.  
  153.  3. Redistributed versions of the original Fnordadel must  not be altered in
  154.     any way.
  155.  
  156.  4. Altered versions of  Fnordadel must be plainly marked as such,  and must
  157.     not  be represented  as the  original Fnordadel.    In particular,  they
  158.     must not be given  the name ``Fnordadel''.  Credit must be given  to the
  159.     original authors.
  160.  
  161.    Basically, you  are free to  do whatever you  like with Fnordadel  except
  162. make money off it or pretend that you wrote it.
  163.  
  164.    This Reference Manual is the original work of, and  is copyright (C) 1991
  165. by, Adrian Ashley and  Royce Howland.  Distribution and modification  of the
  166. manual are subject to the same conditions as for binaries and sources.
  167.  
  168.  
  169. Credits
  170.  
  171.    Fnordadel is  the  aggregate work  of many  people.    Chief among  these
  172. are  Cynbe ru  Taren (CrT),  who did  the original  Citadel  for CP/M;  H.A.
  173. White (Hue, Jr.)   of Minneapolis, who ported Citadel to MS/DOS  and created
  174. Citadel-86; and David  L. Parsons (orc), who ported Citadel-86 to  the Atari
  175. ST and  created STadel.   We (Adrian Ashley  and Royce Howland) took  STadel
  176. and  hacked it  to create  Fnordadel;  any bugs  and  misfeatures should  be
  177. assumed to be our fault alone, unless you're planning to sue.
  178.  
  179.    We would  like to thank  the following  people for their  help and  input
  180. into both Fnordadel and this manual:  John Edstrom,  Hue, Jr., David Parsons
  181. (orc),  David ``Wally''  Williscroft, Garth  Wood, Ken  Badertscher (kbad  @
  182. Virtuality) and many others.
  183.  
  184.    Special thanks  to Garth  Wood, who  contributed material  for the  first
  185. draft of  this manual; as with  everything else we  get, we've hacked it  to
  186. bits, but  an original word or  two probably still remains.   Also to  kbad,
  187. who  proofed the  first draft  of the  Texinfo version  of  this manual  and
  188. provided critiques.  Look, Ken, no Dreaded Emoticons!  (-:  (-:  (-:
  189.  
  190.  
  191.  
  192. Copying Conditions and Credits                                             2
  193.  
  194.  
  195.  
  196.  
  197.    Thanks also to  the loyal users  of secret and RT  (our own boards),  and
  198. our many beta  testers who suffered (and  continue to suffer) through  buggy
  199. beta versions.  We appreciate your input.
  200.  
  201.    Final  thanks to  the  Coca-Cola  company, without  whose  product  (Coke
  202. Classic) we probably would be richer but further behind.
  203.  
  204.  
  205.  
  206. Introduction                                                               3
  207.  
  208.  
  209.  
  210.  
  211. Introduction
  212.  
  213.  
  214.    Fnordadel is a bulletin board  system (``BBS'') program.  It is  a member
  215. of the family of  BBS programs descended from Citadel, which was  written by
  216. CrT in  the early  1980's.   Fnordadel currently  runs on the  Atari ST  and
  217. TT machines  only.   There  are many  other variants and  clones of  Citadel
  218. available for  a wide  variety of  machines, including  the IBM  PC and  its
  219. clones,  the Mac,  the  Amiga, Unix  machines,  and others.    Fnordadel  is
  220. derived from  STadel by  David Parsons  (orc).   See  Appendix B  [History],
  221. page 173, for more on the history and lineage of Fnordadel.
  222.  
  223.    Citadels operate on the  ``room'' metaphor, where discussions  take place
  224. in named rooms  which can be easily and  dynamically managed.   Citadels are
  225. thus considerably different  from most other BBSes,  which tend to use  more
  226. static ``message areas'' and  the like.  Citadel is intended  for discussion
  227. systems, not  heavy file-transfer sites;  however, reasonable file  transfer
  228. mechanisms are provided.  The user interface is  orthogonal, fast and highly
  229. interactive,  while shunning the  typical menu-based  interface of most  BBS
  230. programs.
  231.  
  232.    A few significant features  of Fnordadel (and, in general,  all Citadels)
  233. are:
  234.  
  235.   o __Ease of maintenence__.   Fnordadel requires little  human intervention
  236.     to operate.   Most system files are fixed-size circular files  which are
  237.     inherently self-maintaining.   Barring power failures and bugs,  you can
  238.     let a Fnordadel run for months without even looking at it.
  239.  
  240.   o __Ease  of  configuration__.    All  configuration options  are  in  one
  241.     well-documented  file.     See  Chapter  1   [Fifteen  Minute  Guide  To
  242.     Fnordadel], page 5.
  243.  
  244.   o __Runs on any ST__.  Even if you have only  a 512k machine with a single
  245.     floppy drive, you can still run Fnordadel.
  246.  
  247.   o __Good connectivity__.   Fnordadel supports standard  Citadel networking
  248.     with minimal  incompatibilities with  other Citadel variants.   You  can
  249.     share mail, rooms and files with other Citadels.
  250.  
  251.   o __Flexible security__.  Citadels are traditionally  open systems, but if
  252.     you  have pests, Fnordadel  has a fair  number of  ways to help  control
  253.     them without sacrificing too much of the traditional openness.
  254.  
  255.    Oh,  and since  you may  have been  wondering  ...   :    ``fnord'' is  a
  256. subliminal trigger  word, adapted  from a  well-known science fiction  work.
  257. Since we figure hacking on  BBSes is about as subliminal as you can  get, it
  258. fits.  Besides, all the good names were taken.
  259.  
  260.  
  261.  
  262. Introduction                                                               4
  263.  
  264.  
  265.  
  266.  
  267. Notations Used in This Manual
  268.  
  269.    Several standard notations  are used throughout  this manual, the  online
  270. help files and in general Citadel usage which you should be aware of.
  271.  
  272.  1. The  sequence `^X', where  `X' is a  letter or  symbol on the  keyboard,
  273.     represents a  control character.  To  type one, hold down  the `Control'
  274.     key and press `X'.
  275.  
  276.  2. The sequence `<FOO>'  refers to one of the special keys on  the keyboard
  277.     such  as the  carriage-return key  (`<CR>'), the  escape key  (`<ESC>'),
  278.     etc.    This notation  is also  used  occasionally to  refer to  special
  279.     characters  which may  not  have their  own  keys on  the  keyboard;  an
  280.     example is the linefeed character, `<LF>'.
  281.  
  282.  3. The  sequence  `[X]'  where  `X'  is  any  key,  indicates  a  Fnordadel
  283.     single-key command.   Single-key  commands are usually referenced  using
  284.     a full  word or  two, indicating what  the command means---usually  this
  285.     is derived  from the words  that Fnordadel echoes  back to you when  you
  286.     press the key.   For example, `[N]ew' refers to the command to  read new
  287.     messages; you press `N' and the system echoes `New'.
  288.  
  289.  4. The  sequence `.X(stuff) Y(stuff)  Z(stuff) ...'  indicates a  Fnordadel
  290.     multi-key command.  Such commands always  start with a special character
  291.     such  as `.',  `;' or  `!'.   The  text in  parentheses represents  what
  292.     Fnordadel will e